Microsoft® Visual Basic® Scripting Edition OpenTextFile Method

Language Reference

See Also                   Applies to

Description

Opens a specified file and returns a TextStream object that can be used to read from or append to the file.

Syntax

[object.]OpenTextFile(filename[, iomode[, create[, format]]])

The OpenTextFile method has these parts:

Argument	Description
object	Optional. Object is always the name of a FileSystemObject.
filename	Required. String expression that identifies the file to open.
iomode	Optional. Constant, either ForReading or ForAppending, indicating that the file is open for reading or appending.
create	Optional. Boolean value that indicates whether a new file can be created if the specified filename doesn't exist. The value is True if a new file is created, False if it isn't created. If omitted, a new file isn't created.
format	Optional. One of three Tristate values used to indicate the format of the opened file. If omitted, the file is opened as ASCII.

Settings

The format argument can have any of the following settings:

Value	Description
TristateTrue	Open the file as Unicode.
TristateFalse	Open the file as ASCII.
TristateUseDefault	Open the file using the system default.

Remarks

The following code illustrates the use of the OpenTextFile method to open a file for appending text:

Dim fs, a
Set fs = CreateObject("Scripting.FileSystemObject")
Set a = fs.OpenTextFile("c:\testfile.txt", ForAppending, FALSE)
...
a.Close